cs-payu-sapi
📘 Documentación de la API - CS PayU SAPI
Esta sección describe los atributos y uso de la cs-payu-sapi, versión v1. Esta System API interactúa directamente con la PayU REST API para realizar operaciones de tokenización, pagos, reembolsos y reportes.
💂️ Información Base
- Título de la API: cs-payu-sapi
- Versión: v1
- URL Base:
https://cs-payu-sapi-{env}-v1.us-e1.cloudhub.io/api/ - Entornos:
dev,qa,prod
🔑 Autenticación
Encabezados Requeridos
| Encabezado | Tipo | Descripción |
|---|---|---|
| Authorization | String | Token Bearer en el formato Bearer {{API_KEY}} |
| client_id | String | Identificador único para clientes API |
📌 Estos encabezados son requeridos en todas las solicitudes.
✨ Endpoints Principales
📄 Tokenización de Tarjetas de Crédito
POST /credit-card/tokens
- Descripción: Crea un token para una tarjeta de crédito.
- Solicitud y Respuesta: Ver ejemplos en
examples/requests/post-token.jsonyexamples/responses/post-token.json.
GET /credit-card/tokens
- Descripción: Obtiene tokens de tarjetas de crédito filtrados por rango de fechas.
- Parámetros de Consulta:
startDate:datetime-onlyendDate:datetime-only
DELETE /credit-card/tokens/bulk
- Descripción: Elimina múltiples tokens de tarjetas de crédito vía carga de archivo.
- Formatos de Cuerpo Soportados:
application/json,text/csv,application/octet-stream
POST /credit-card/tokens/bulk/registration
- Descripción: Registra múltiples tokens de tarjetas de crédito usando un archivo.
DELETE /credit-card/tokens/{tokenId}
- Descripción: Elimina un token específico de tarjeta de crédito.
- Parámetro de Consulta Requerido:
payerId
💰 Pagos
GET /payments/available-methods
- Descripción: Obtiene métodos de pago disponibles.
POST /payments/credit-card
- Descripción: Procesa un pago con tarjeta de crédito.
POST /payments/cash-or-referenced
- Descripción: Procesa un pago en efectivo o basado en referencia.
POST /payments/PSE
- Descripción: Procesa un pago PSE (transferencia bancaria en línea).
POST /payments/bulk-tokens
- Descripción: Procesa múltiples pagos usando tokens desde un archivo.
🏦 PSE (Banca en Línea)
GET /PSE/banks
- Descripción: Obtiene la lista de bancos disponibles para pagos PSE.
📊 Reportes
GET /reports
- Descripción: Obtiene detalles de transacciones basados en un
referenceCode.
💸 Reembolsos
POST /refunds
- Descripción: Envía una solicitud de reembolso completo.
POST /partial-refunds
- Descripción: Envía una solicitud de reembolso parcial.
⚠️ Códigos de Error
| Código | Descripción | Solución Sugerida |
|---|---|---|
| 400 | Solicitud Incorrecta | Verificar parámetros de consulta. |
| 401 | No Autorizado | Verificar credenciales de autenticación. |
| 404 | No Encontrado | No se encontraron datos para la entrada proporcionada. |
| 500 | Error Interno del Servidor | Reintentar o contactar soporte técnico. |
📞 Soporte
Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.
Correo electrónico: epalma@fgs.co
📅 Información Adicional
- Documentación actualizada por última vez: Septiembre 2025*
- Para actualizaciones adicionales, consulta el Portal de Exchange de API
Documentación actualizada en Septiembre 2025 por epalma@fgs.co - Edna Nayibe Palma
© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-utilities-system-api-services